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0 . INTRODUCTION 



The Time Series Editor is a collection of FORTRAN programs 
controlled by a master program called TIMESER EXEC in the CP/CMS 
executive language. The package has been designed for the 
analysis and forecasting of time series data using the Box-Jenkins 
modelling methodology. For a complete description of the Time 
Series Editor, see Richards and Woodall [Ref. 16]. This Guide 
contains the minimum information that is required for the user 
to access the Time Series Editor, enter data, build a model, 
evaluate the model, forecast, and obtain output. 

I . DATA INPUT 

The Time Series Editor requires that time series data be 
entered into the sequential FORTRAN input/output file named 
FILE FT02F001. This can be done either online or via cards 
read offline. The following page shows the proper card deck 
arrangement for reading data offline. The data deck must be given 
to the computer center system operator for entry into CP. 

If the user has a data deck already punched up in a format 
other than 5F15.6, he may enter the series as above into 
FILE FT03F001 ( without the length of series card) and use the 
Editor program ZFORMAT to transform it into the FILE FT02F001 
in the proper format, without destroying his original file. 

This program is described in the next section. 



3 



DATA ENTRY DECK 
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II. 



TABLE OF OPTIONS 



This Table provides the user with the basic information 
necessary to understand the data requirements, functions 
and output options for each program in the Editor. 
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III. THE BASIC USER SESSION 



To use the Time Series Editor, the user must log into 
CMS, get into CP, link to the disc storage area where the 
Time Series Editor resides, reimplement CMS, log into the 
general user and Time Series Editor disc areas, and enter 
the TIMESER routine. This section will provide explicit 
guidelines to enable the user to perform the above steps 
on the NPS CP/CMS system. Commands marked with an asterisk 
(*) are those actually entered on the terminal by the user 
(the asterisk itself is omitted) . Those without an aster- 
isk and those written in all capital letters are system 
responses at the terminal. Numbered sentences are comments, 
which will not appear during an actual user session. The 
instructions and system responses assure the user is on an 
IBM 2741 Input/Output Terminal. Some minor modifications 
may be necessary if other terminals are used. 



1. Turn the terminal on, depress the BREAK key, and wait 
for the system to respond: 

CP-67 online xd.65 gsyosu 

2. Depress the ATTN key. The roll bar will advance and 
the keyboard will unlock. Then enter: 

*login aaaapbb 450k 

3. aaaa is the user's identification number, and nn is the 
terminal number (usually written on the terminal) . 

For example, if the user's ID number is 1621 and the 
terminal number is 44, the input would be: 
login 1621p44 450k. The addition of 450 k to the normal 
login command is necessary to execute the program 
WMARQRDT in the Editor; for users not planning to 
execute this program during a session, this addition 
is not necessary. 
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4. The system will respond with the statement: 

ENTER PASSWORD: 

5. The user then enters his password, or the general users 
password npg; 

*password 

6. The system will then respond: 

ENTER 4-DIGIT PROJECT NUMBER FOLLOWED BY 4-CHARACTER 
COST CENTER CODE: 

7. The user then enters: 

*gggghhhh 

8. gggg is the assigned project number, and hhhh is the 
user's section designator or the faculty code. 

9. The system will respond with the message of the day, 
such as: 

CP/CMS HOURS ... 0930=2200 (MON-THURS) ... 0930-1800 (FRI) 
OUTPUT RETAINED 5 DAYS 
Cms Version 3.25 

10. At this point, the user is in CMS. He must then get into 
CP; this can be done by hitting the ATTN key. The system 
will then respond: 

CP 

11. The user must then link to the TIME SERIES EDITOR; 
this is accomplished by entering: 

*link 2069p 191 192 

12. The system will respond with: 

ENTER PASSWORD: 

13. The password (read only) to enter the Editor is: 

*timser 

14. The system then responds: 

SET TO READ ONLY 
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15. The user now implements CMS by: 

*ipl cms 

16. The system will respond: 

CMS Version 3.25 

17. Now the user must log into both the general user and 
the Time Series Editor area by entering: 

♦login 191 

18. The system will respond with a message such as: 

R; 

19. The user then enters the command: 

♦login 192 t,p 

20. The system will respond: 

T (192) R/0 

R; 

21. The user can then enter the Time Series Editor 
(guided version) by entering the command: 

♦timeser 

22. The system will respond: 

EACH 2 SECONDS EXECUTION TIME IS INDICATED BY * 

YOU HAVE ENTERED THE TIME SERIES EDITOR 

PLEASE RESPOND TO EACH QUERY WITH AN INPUT AT THE TERMINAL. 
ENTER ONLY THE FIRST LETTER FOR A WORD RESPONSE. 

ENTER NUMERICAL VALUES VIA FORTRAN FORMAT.. 

TYPE INTEGER VALUES (RIGHT JUSTIFIED) FOR NAMES STARTING 
WITH I THROUGH N. TYPE FLOATING VALUES WITH DECIMAL FOR 
ALL OTHERS. 

DO YOU WANT A LIST OF THE OPTIONS? 

23. The user is then on his own, guided by the Exec routine. 

See the notes that appear at the end of this guide for 
additional information. Eventually the user will be 
asked: 

DO YOU WANT TO TRY AGAIN? 
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24 . 



If a yes response is given, another sequence will begin; 
if the response is no, the user will be taken out of 
the Time Series Editor environment and returned to CMS. 
The system response will be: 

CONTROL RETURNED TO CMS 

r; 

25. The user can then log out of CMS by typing: 

*cp logout 

26. The system will respond with: 

CONNECT= 00:08:02 VIRTCPU= 000:07.98 TOTCPU= 000.10.94 
LOGOUT AT 14.22.04 on 10/16/78 

27. The user should then turn off his terminal and tear off 
the output from his session. 

The more experienced user can dispense with the 
"welcome aboard" section of the Time Series Editor and get 
right down to business by using the shortened version of the 
Editor. This shortened version may be entered by linking in 
the normal way, and then entering the Editor by typing the 
COMMAND 

*timeser s (asterisk omitted) . 

The system will immediately respond: 

ENTER LETTER FOR OPTION YOU WANT. 



The session inside the Editor then begins. 



16 



IV. BRIEF SAMPLE USER SESSION 



A brief sample user session is given below; it includes 
copies of the offline output generated during the session. 
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repeat login nur@pn@ 



login 1 621p44 450k 
ENTER PASSWORD: 

ENTER 4-DIGIT, PROJECT NUMBER FOLLOWED BY 4-CHARACTER COST CENTER CODE 
0444r 172 

READY AT 17.24.38 ON 09/16/78 
CMS Version 3.25 

stat 

P (191): 29 FILES; 241 REC IN USE, 55 LEFT (of 296), 81% FULL (2 CYL) 
R; 

cp q f 

FILES:- NO RDR, NO PRT, NO PUN 

R; 

CP 

link 2069p 191 192 
ENTER PASSWORD: 

SET TO READ ONLY 

ipl eras 

CMS Version 3.25 

login 191 

R; 

login 192 t,p 
T (192) R/O 
R; 

timeser 

EACH 2 SECONDS EXECUTION TIME IS INDICATED BY *. 

YOU HAVE ENTERED THE TIME SERIES EDITOR. 

PLEASE RESPOND TO EACH QUERY WITH AN INPUT AT THE TERMINAL. 

ENTER ONLY THE FIRST LETTER FOR A WORD RESPONSE. 

ENTER NUMERICAL VALUES VIA FORTRAN FORMAT. 

TYPE INTEGER VALUES (RIGHT JUSTIFIED) FOR NAMES STARTING 

WITH I THRU N. TYPE FLOATING VALUES WITH DECIMAL FOR ALL OTHERS. 

DO YOU WANT A LIST OF THE OPTIONS? 

y 



OPTION DESCRIPTION 

GENERATE GENERATE ANY ARIMA TIME SERIES 

AUTO CALCULATE AUTOCORRELATIONS, PAUTOS, MEAN AND VARIANCE 

PLOT PLOT A TIME SERIES 

ESTIMATE CALCULATE MAX LIKELIHOOD ESTIMATES OF ARMA PARAMETERS 

DIFF DIFFERENCE A TIME SERIES 

FORECAST FORECAST FUTURE VALUES, CONSTRUCT CONFIDENCE INTERVALS 

TRANS -‘TRANSFORMS VALUES OF A TIME SERIES 

ROOTS DETERMINES ROOTS OF ARIMA CHARACTERISTIC EQUATION 

Z FORMAT ALTER DATA FILE TO FORMAT 5F15.6 

CMSWORK PERFORM CP/CMS COMMANDS IN TIMESER EXEC 

SIMULATE SIMULATE NONSEASONAL TIME SERIES 

YESTSEAS CALCULATE INITIAL SEASONAL PARAMETERS 

WMARQRDT MARQUARDT SOLUTION FOR PARAMETER ESTIMATES 

XSUMSQ CALCULATE SUM OF SQUARES FOR ARBITRARY PARAMETERS 



WOULD YOU LIKE MORE INFO? 

y 
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ENTER OPTION YOU WANT INFO ABOUT. 

a 

AUTO THIS PROGRAM CALCULATES AUTOCORRELATIONS , PARTIAL 

AUTOCORRELATIONS , THE MEAN AND THE VARIANCE FOR A GIVEN TIME SERIES 
WHICH MUST RESIDE IN FILE FT02F001. THE PROGRAM USES 
FTAUTO IN THE IMSL LIBRARY. THE AUTOCORRELATIONS AND PAUTOS CAN BE 
PLOTTED OFFLINE. 



DO YOU WANT INFO ABOUT ANOTHER OPTION? 

n 

DO YOU WANT TO TRY A SESSION? 

y 



ENTER LETTER FOR OPTION YOU WANT. 

C 

ENTER DESIRED CP/CMS COMMANDS, ONE PER LINE. 



WHEN FINISHED TYPE 


: &GOTO 


-QUES 




listf * 


f t02 f 001 








FILENAME 


FILETYPE 


MODE NO. 


REC. 


DATE 


SERG 


FT02F001 


PI 


3 


9/16 


SERC 


FT02F001 


PI 


5 


9/16 


LNSERG 


FT02F001 


PI 


3 


9/16 


FILE 


FT02F001 


PI 


1 


9/16 



erase file ft02f001 

alter sere ft02f001 pi file ft02f001 pi 
stat 

P (191): 28 FILES; 240 REC IN USE / 56 LEFT (of 296), 81% FULL (2 CYL) 
fcgoto -ques 

DO YOU WANT TO GO AGAIN? 

y 



ENTER LETTER FOR OPTION YOU WANT, 
a 

IS YOUR DATA IN FILE FT02F001? 

y 

EXECUTION BEGINS. . . 

AUTOCORRELATIONS 

/ 

0.978 0.944 0.902 0.854 0.802 0.748 0.692 0.635 0.579 0.923 

0.468 0.413 0.359 0.305 0.253 0.201 0.150 0.098 0.047 -0.003 

-0.052 -0.101 -0.151 -0.200 -0.248 



PARTIAL 

0.978 -0.260 -0 
-0.036 -0.041 -0 
-0.034 -0.061 -0 



AUTOCORRELATIONS 

157 -0.093 -0.058 
038 -0.024 -0.037 
079 -0.048 -0.037 



-0.045 -0.012 -0 
-0.027 -0.032 -0 



038 -0.022 -0.010 
070 -0.048 -0.024 



MEAN® 22.9739 VARIANCE = 4.22273 

ENTER TITLE FOR PLOTS, 
autos and pautos for series c data 
YOUR AUTO AND PAUTO PLOTS HAVE BEEN PRINTED OFFLINE. 
PICK UP IN ROOM 1140 UNDER YOUR USER ID NUMBER. 

DO YOU WANT TO GO AGAIN? 

y 

ENTER LETTER FOR OPTION YOU WANT, 
c 

ENTER DESIRED CP/CMS COMMANDS , ONE PER LINE. 

WHEN FINISHED TYPE: &GOTO -QUES 
offline print file ft02f001 
alter file ft02f001 pi sere ft02f001 pi 
fcgoto -ques 

DO YOU WANT TO GO AGAIN? 
n 

CONTROL RETURNED TO CMS 
R; 
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► FAfv* 22.9739 VARIANCE = 4.22273 
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AUTCCCR9FLATICNS WITH 2 SIGMA BANOS 



o 

o 



o 



m 




rf\ 


ro 


o 


m 


• 


• 


• 


o 


o 


o 



♦ 



vO 

o 



o 

o 



I 



*44.11*4*4* f * f « 


4 4 4 * 4 44**44*4**+*4 


4*44444 + 444 * 44 * 4.4 


♦ »l|l 4t 








* o 


u+ 


• * 


♦ 


40 


•« 


• 




♦ • 




• •* 


4 


* -4 


>T4 


• 




* NT 


♦ 


• If 


♦ 


4 


* 


• 




4 


4 


• * 


♦ 


4 


4 


• 




4 


* 


• If 


♦ 


4 


4 


• 




4 


♦ 


• * 


♦ 


4 


♦ 


• 




4 


4 


• • 4 


♦ 


If 


4 


• 




4 


4 


• 4 




If 


4 


t 




* 


4 


• * 


♦ 


# 


4 


• 




4 


* 


• * • 


♦ 


4 


O* 


• 




4 O 


O* 


• * 


♦ 


4 O 


• 4 


• 




* • 


^ Jf 


* *# 


4 


If ^ 


m* 






* m 


* 


• •* 


♦ 


4 


# 


• 




4 


* 


• • * 


4 


4 


♦ 


• 




4 


♦ 


• • *- 


T 


V 


* 


• 




4 


♦ 


• * 


♦ 


4 


* 


• 




4 


# 


• «4 


♦ 


4 


* 


• 




4 


* 


• •« 


♦ 


4 


* 


• 




4 


*• 


• • If 


♦ 


4 


* 


• 




4 


* 


• *4 


♦ 


4 


<-** 


• 




4 O 


04 


• • * 


♦ 


40 


• * 


• 




4 • 




• •* 


♦ 


4 -H 


*N(* 


• 




4 fNJ 


* 


• •* 


♦ 


4 


* 


• 




4 


* 


• • If 


♦ 


4 


4 


• 




4 


« 


• • * 


4* 


4 


* 


• 




4 


4 


• *4 


♦ 


4 


4 


• 




4 


* 


• •» 


♦ 


4 


4 


• 




4 


* 


• *4 


4 


4 


* 


• 




4 


* 


• • If 


♦ 


4 


4 


• 




4 


4 


• • * 


4 


4 


o* 


• 




* O 


04 


• •* 


4 


4 O 


.* 


• 




4 • 


-44 


• ■* 


4 


4 ^ 


Ht 1 


• 




4 -4 


* 


• • 4 


4 


4 


* 


• 




1 


4 


• *11 


4 


4 


* 


• 




4 


4 


• If 


4 


4 


4 


• 




4 


V 


■ • «t 


4 


4 


4 


• 




4 


♦ 


• • * 


4 


4 


w 


• 




4 


♦ 


• • 


4 4 


* 


4 


• 




4 


♦ 


• • 


4 * 


4 


* 


• 




4 


♦ 




4 * 


4 


C*4 


• 




4 O 


Of * 


• • 


4 


4 O 


• f 






4 • 






U 


r- 


m 




CM 


h- 


U 


o 


CM 


O 


P» 


>o 


• 


• 


• 


• 


• 


• 


ri 


o 


u 


o 


0 

1 


u 

1 



22 



PmiAL AUTOCCPBFtATI CMS WITH 2 SIGMA BAM OS 
ALTOS AMC PAUTOS F CR SRBIFS C DATA 



FILE: SfcRC FT02F001 PI 
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V. PROBLEM CONTROL NOTES 



This section will cover corrective measures that can be 
taken when things fail to go as expected while in the 
TIMESER environment. 

a. A typing error in the CMS environment can be 

corrected by typing the @ character as many times as is 
required to back up and then type the correct values. For 
example, if the user typed timesre , the user could correct 
the mistake by typing two @ signs, followed by the correct 
spelling er, as follows: timesre@@re ♦ An entire line can 

be deleted by typing the <? character (or [ on some terminals) . 

b. When working with TIMESER executive programs, the 
user should exercise care before hitting the return key (or 
control s on some terminals) . If an input value is required 
and the return key is hit before the proper response is 
entered, the user will be likely to get thrown out of the 
editor and have to begin again. In most cases, errors can 
be corrected only before the return key is struck (in some 
programs you get a second chance for input) . 

c. Particular care should be taken for integer value 
input, which must be right justified in the format field. 

The editor will advise the user in all cases where the 
integer format is other than II. 

d. If for any reason the user finds himself in a debug 
or error condition (caused by erroneous data, or a "blowup" 
in one of the non-linear optimization routines usually 
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caused by very poor initial input values) , the following 
procedure will get the user back into the normal TIMESER 
environment : 

(1) depress the ATTN key twice; this gets 
the user into CP; hit the ATTN key again, 
and then type kx to kill the execution. 

(2) re-ipl CMS, and login 191 and then login 
192 t,p. 

(3) then the user can type TIMESER or TIMESER S, 
and return to the TIMESER environment 

On the next page is a sample user session where an error 

causing a debug condition has occurred. 

Here the user executed a program that required data 
in FILE FT02F001, and the FILE did not exist. As the 
example shows, recovery is quick. Simply hit the break 
button to get into CP, login 191, login 192 t,p, and then 
type timeser s to return immediately to the Editor environment. 
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ENTER LETTER FOR OPTION YOU WANT 
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A HEN FINISHED TYPE: &GOTO -QUES 

alter sere ft02f001 pi file ft02f001 pi 

&goto -ques 

DO YOU WANT TO GO AGAIN? 
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